| [ << ] | [ < ] | [ Up ] | [ > ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
In diesem Kapitel finden vermutlich nur Programmierer Interessantes.
| 1.1 Was ist die beste Dokumentation fr Programmierer? | ||
| 1.2 Was ist CATS? | ||
| 1.3 Wo bekomme ich die Amiga-Include-Dateien? | ||
| 1.4 Wie werde ich Developer? | ||
| 1.5 Was fr Compiler (und Assembler) gibt es? | Was fr Compiler (Assembler) gibt es? | |
| 1.6 Warum funktioniert keine Esc-Sequenz? | ||
| 1.7 Kann ich AmigaBasic auf dem A1200 verwenden? | ||
| 1.8 Wie lokalisiere ich mein Programm? | ||
| 1.9 Wie erhlt man einen Zeiger auf das Fenster einer Konsole? | ||
| 1.10 Was sind Pragmas? | ||
| 1.11 Mein Compiler/Linker vermit Symbole. | ||
| 1.12 Wie erfahre ich, was fr Funktionen es gibt? | ||
| • Der GNU C Compiler | Der GNU C Compiler: Allgemeine Information und Installation |
| [ << ] | [ < ] | [ Up ] | [ > ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
Die beste verfgbare Dokumentation sind sicherlich die RKM’s (ROM Kernel Manuals, die schwarzen) von Commodore. Sie werden von Addison-Wesley verffentlicht.
The Amiga ROM Kernel Manual: Libraries, ISBN 0-201-56774-1
The Amiga ROM Kernel Manual: Devices, ISBN 0-201-56775-X
The Amiga ROM Kernel Manual: Includes and Autodocs, ISBN
0-201-56773-3
The Amiga Hardware Manual, ISBN 0-201-56776-8
The Amiga User Interface Style Guide, ISBN 0-201-57757-7
Vor allem die Libraries sind ein Mu. Weniger ntzlich sind die Includes und Autodocs: Sie sind auf Diskette als Online-Hilfe sicher ntzlicher. See section Wo bekomme ich die Amiga-Include-Dateien?.
AmigaDOS wird in diesen Bchern kaum behandelt. Die Autodocs geben einige Informationen, aber um tiefer einzusteigen braucht man das
The AmigaDOS Manual, 3rd Edition, ISBN 0-553-35403-5
ebenfalls von Commodore, das von Bantam Books herausgegeben wird.
Eine gute Wahl ist auch
The Amiga Guru Book
von Ralph Babel. Das Buch beginnt mit einem ca. 250-seitigen allgemeinen berblick ber verschiedenste Aspekte der Programmierung des Amiga. Fr Anfnger drften vor allem die Abschnitte ber die Amiga-Datentypen sowie die Amiga-Includes und die amiga.lib interessant sein, aber auch Erfahrene finden hier mit Sicherheit noch Neues, was zum Teil nicht einmal in den RKM’s enthalten ist. Den grten Teil des Buches nehmen aber 500 Seiten nur zu AmigaDOS ein. Dieser Teil ist meines Erachtens der wichtigste, weil das AmigaDOS-Manual der schlechteste Teil der offiziellen Dokumentation ist. Das Buch ist sehr dicht geschrieben und deshalb weniger leicht lesbar als die RKM’s, aber ich empfehle es als Zusatz und vor allem anstelle des AmigaDOS-Manuals. (Allerdings ist das Guru-Buch kein Ersatz fr die Libraries & Devices, die hier nicht behandelt werden.) Unglcklicherweise hat das Buch keine ISBN-Nummer und ist deshalb nur bei den folgenden Adressen erhltlich:
Almathera Systems Limited
Southerton House
NBG USA, Inc. Boundary Business Court
482 Holly Avenue 92-94 Church Road
St. Paul, MN 55102 Mitcham, Surrey CR4 3TD
USA England
Voice: +1 (612) 290 9447 Voice: +44 181 687 0040
Fax: +1 (612) 290 9449 Fax: +44 181 687 0490
E-Mail: <almathera@cix.compulink.co.uk>
Stefan Ossowskis Schatztruhe
Hirsch & Wolf OHG Gesellschaft fr Software mbH
Mittelstrae 33 Veronikastrae 33
D-56564 Neuwied D-45131 Essen
Germany Germany
Voice: +49 (2631) 8399-0 Voice: +49 (201) 788778
Fax: +49 (2631) 8399-31 Fax: +49 (201) 798447
E-Mail: <stefano@tchest.e.eunet.de>
Someware
27 rue Gabriel Pri
59186 Anor
France
Voice: +33 27596000
Fax: +33 27595206
E-Mail: <didierj@swad.someware.com>
Fr weitere Informationen empfehle ich auch die FAQ von Marc Atkins ber
Bcher zum Thema Amiga, die alle 4 Wochen in comp.sys.amiga.misc
erscheint.
| [ << ] | [ < ] | [ Up ] | [ > ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
Dies ist eine Abteilung von Commodore West Chester, die frher
Commodore Amiga Technical Support hie und spter in
Commodore Application and Technical Support umbenannt wurde. Die
Mitglieder arbeiten unabhngig
von der Entwicklungsabteilung, aber eng mit ihr zusammen, und versuchen,
Entwicklern auerhalb von Commodore beim Erstellen guter Amiga-Anwendungen
zu helfen, sei das eine Hard- oder Software. Dazu hat CATS eine Menge
an Informationen und Tools gesammelt, auf Floppy, CD oder Papier. Ein
groer Teil dieses Materials ist auch der Allgemeinheit, d. h. fr
Nicht-Developer zugnglich. Aber bitte CATS nicht mit einer Hotline
verwechseln!
Amerikaner knnen das Material von
CATS
Commodore Electronics Limited
950 Rittenhouse Road
Norristown, PA 19403
bekommen, der Distributor fr ganz Europa ist die
Fa. Hirsch & Wolf
Mittelstr. 33
56564 Neuwied
Tel. 02631/83990
Dr. Peter Kittel, peterk@cbmger.de.so.commodore.com
| [ << ] | [ < ] | [ Up ] | [ > ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
Der einzige legale Weg, die Include-Dateien und die AutoDocs zu bekommen
(und Sie sollten sie bekommen, sie sind sehr ntzlich!), ist,
Developer zu werden (siehe see section Wie werde ich Developer?) oder das sogenannte NDU
(Native developers update kit, auch als NDUK, NDK bekannt oder
ADU fr Amiga Developer Update)
bei CATS zu kaufen. See section Was ist CATS?. Es kostet etwa 50DM, was sicher ein
fairer Preis ist. Dabei handelt es sich um ein 5-Disketten-Set, das neben
den aktuellen Includes und AutoDocs auch Tools fr Programmierer,
z.B. Enforcer, Mungwall, Sushi und die debug.libg (zum Debuggen) sowie
anderes, z.B. CatComp (see section Wie lokalisiere ich mein Programm?) oder Report (fr
Bug-Reports oder Vorschlge an Commodore) enthlt. Die aktuelle
Version ist 3.1 und fr Programmierer beinahe obligatorisch.
Wem die Includes gengen, der kann diese ber ein Update seines Compilers (nur kommerzielle Compiler) oder von den Fish-CDs bekommen. @xref{Fish-CD}.
| [ << ] | [ < ] | [ Up ] | [ > ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
Um Developer zu werden, braucht man die ADSP-Antragsformulare (Amiga
developer support program). Um diese zu bekommen, sollte man einen Brief
an die lokale Commodore-Niederlassung schreiben und nach diesen Papieren
fragen, in denen das weitere erklrt wird. In Deutschland ist die
Adresse folgende:
Commodore
Lyoner Strae 38
60528 Frankfurt
Es gibt drei verschiedene Arten von Developern:
Hier bekommt man vor allem Zugang zum CBMNET (eine Art Commodore-internes Usenet), ber das man direkt mit anderen Entwicklern auch von Commodore selber ber seine Probleme diskutieren kann. Die Jahresgebhr betrgt 150 DM, die einmalige Aufnahmegebhr 50 DM.
Dies ist die interessanteste Klasse: Man bekommt von der meisten Systemsoftware die aktuellen Beta-Versionen (z. B. Kickstart und Workbench) sowie die dazugehrigen Includes und AutoDocs. Certifieds bekommen aber nicht jede Beta und in der Regel auch keine Hardware-Beta. Man bezahlt 400 DM pro Jahr dafr und eine einmalige Aufnahmegebhr von 100 DM.
Kommerzielle Entwickler bekommen im wesentlichen dieselben Informationen wie die "Zertifizierten", allerdings kompletter, sprich auch Beta-Hardware, und etwas frher. Dies hat auch seinen Preis: 700DM pro Jahr plus einmalige Aufnahmegebhr von 100DM.
Die Preise und die angebotenen Mglichkeiten knnen von Land zu Land verschieden sein, auch gibt es meines Wissens nicht in allen Lndern den "Registered". Ein guter Tip ist es, eine Gruppe zu bilden und damit die Kosten zu reduzieren.
Alle Entwickler mssen Non-disclosure agreements (NDA) unterzeichnen.
Diese besagen, da sie ber die erhaltenen Informationen auerhalb von
speziell dazu freigegebenen Orten oder Kanlen nicht einmal zu anderen
Entwicklern sprechen drfen, so lange sie nicht die explizite Erlaubnis
dazu von Commodore haben.
| [ << ] | [ < ] | [ Up ] | [ > ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
Es gibt viele Programmiersprachen auf dem Amiga, kommerzielle Compiler ebenso wie frei kopierbare. Ich mchte nur diejenigen aufzhlen, die mir bekannt sind oder die ich aus einem anderem Grund fr erwhnenswert halte.
Alle C-Compiler beinhalten einen Assembler. Frei kopierbar und zuverlssig sind A68K und PhxAss. (Aminet, Directory ‘dev/asm’ oder Fish-Disks 521 bzw. 906)
Kommerzielle Assembler sind MaxonASM, OMA3.0 und DevPack3.14.
Derzeit sind folgende kommerzielle Basic-Compiler/Interpreter verfgbar: BlitzBasic2, Amos und MaxonBasic3.
Frei kopierbare C-Compiler sind der gcc (der sein eigenes Directory
‘dev/gcc’ auf dem Aminet hat) und die Probeversion (mit der man aber
schon eine ganze Menge anfangen kann) von Dice (per FTP von
ftp.uni-paderborn.de, Directory
‘/news/comp.binaries.amiga/volume91/languages’ oder auf Fish disk 491).
Der groe Vorteil von gcc ist, da man ihn auf der ganzen Welt
und auf nahezu jedem Computer findet. Ein weiterer Vorteil ist, da er sogar
einen C++-Compiler enthlt! Aber er ist langsam und bentigt 4MB RAM oder
mehr. @xref{Der GNU C Compiler}. @xref{Mail-Listen}.
Kommerzielle C-Compiler sind Aztec-C, Dice, SAS-C
und MaxonC++.
Aztec-C wird jedoch leider nicht mehr weiterentwickelt.
Was die kommerziellen Compiler auszeichnet, sind ihre hervorragenden
Source-Level-Debugger, die den anderen fehlen.
SAS hat leider angekndigt, den Amiga-Compiler nicht weiter zu untersttzen. Verkauft wird er aber noch, und da er gegenwrtig noch voll aktuell ist und sogar einen Crosscompiler von C++ in C enthlt (der vom Debugger untersttzt wird), ist er meines Erachtens derzeit das beste Angebot, insbesondere zu dem uerst gnstigen Preis von 184.-DM fr Studenten und Besitzer anderer Compiler. In Deutschland erhlt man SAS/C bei
SAS Institute, Inc. SAS Institute GmbH
Book Sales Postfach 10 53 40
SAS Campus Drive 69043 Heidelberg
Cary, NC 27513 Deutschland
USA
Phone: (919)677-8000 Telefon: 06221/4160
EMail: sasdsb@vm.sas.com EMail: eurdoc2@vm.sas.com
Dice bietet wie SAS einen Sonderpreis fr Schler und Studenten von ca. 130.-DM. Der Compiler ist stabil und vor allem sehr schnell. Der grte Nachteil von Dice ist (verglichen mit den anderen kommerziellen Compilern) der Debugger, ein sogenannter Source-Line-Debugger: Dies bedeutet, da man den Quelltext sieht und das Programm Schritt fr Schritt abarbeiten kann, aber leider nur Speicher und nicht etwa bestimmte Variablen anzeigen kann. Informationen ber Dice: info@oic.COM.
Comeau C++ ist ebenfalls ein Crosscompiler, was an und fr sich kein
Problem wre. Aber Comeau C++ hat keinen integrierten C-Compiler,
man braucht also zustzlich SAS-C, Aztec-C oder Dice. Dafr ist er
kompatibel zu AT&T cfront 3.0, untersttzt Exceptions und luft wie
gcc auf vielen verschiedenen Systemen. In Deutschland wird auch
Maxxon C++ angeboten, ber das ich nichts sagen kann. Beide Compiler
sind kommerziell. Comeau’s Adresse ist:
Comeau computing
91-34, 120th Street
Richmond Hill, NY, 11418-3214
USA
EMail: Greg Comeau, comeau@bix.com
MaxonC++ ist sowohl ein C++ als auch ein C Compiler. Es gibt eine Light-Version fr ca. 190 DM und eine Developer-Version fr ca. 450 DM. Die Developer-Version entspricht dem AT&T-Standard 3.0. Maxon-Light enthlt einen Compiler und einen Editor. Developer umfat einen Source-Level-Debugger, eine Amiga-Klassenbibliothek und Hot Help mit Dokumenten zu den Amiga-Libs. Da es ein deutsches Produkt ist, sind Compiler und Dokumentation in Deutsch gehalten. Der Compiler besitzt einige kleinere Fehler, trotzdem kann man mit ihm gut arbeiten.
JForth soll eine exzellente Forth-Version sein. Unter anderem enthlt es objektorientierte Erweiterungen, ein volles Amiga-Interface und einen Anwendungsgenerator. Es ist erhltlich von:
Delta Research
P.O. Box 151051
San Rafael, CA 94915-1051
Phone: (415) 453-4320
EMail: Phil Burk, phil@ntg.com
Mike Haas, haas@starnine.com
(Seufz! Es gibt immer noch Leute, die es brauchen :-<) Frei kopierbar sind BCF (Fish disk 470) und f2c, der Fortran in C-Quelltext umwandelt. (Aminet, Directory ‘/dev/lang’). Ein kommerzieller Compiler ist von ABSoft erhltlich. Allerdings sind dies alles nur Fortran-77-Compiler, es gibt keine Fortran-90-Compiler auf dem Amiga.
Frei kopierbare Lisp-Interpreter sind XLisp (Fish-Disk 181) und OakLisp
(Fish-Disks 519 und 520) und CLISP (‘/pub/lisp/clisp/binaries/amiga’ at
‘ma2s2.mathematik.uni-karlsruhe.de’). Auch Compiler gibt es: Gambit
(Fish-Disks 764 und 765) sowie Scheme-to-C (Fish-Disks 556-558). Von
Interesse ist vielleicht eine Mail-Liste: Senden Sie dazu eine Mail mit dem
Wort ‘Subscribe’ an amigalisp@contessa.phone.net.
‘/dev/lang/UNSWProlog.lha’ und ‘dev/lang/sbp3_1e’ auf dem Aminet sowie ‘SBProlog’ auf der Fish-Disk 141 und ‘SBProlog’ auf der Fish-Disk 145 sind frei kopierbare Prolog-Interpreter.
M2Amiga wird in Europa und Benchmark Modula-2 in den USA angeboten. Beide sollen sehr gut sein und sowohl ber gute Source-Level-Debugger als auch eine umfangreiche Bibliothek verfgen. Besonders M2Amiga wird sehr gut untersttzt durch eine deutsche Benutzergruppe (AMOK), die z.B. eine eigene PD-Serie anbieten. @xref{Mail-Listen}.
M2Amiga bekommt man bei
A+L AG
Daderiz 61
2540 Grenchen
Schweiz
Tel.: +41/65/52 03-11
Fax: -79
und Benchmark Modula-2 ist erhltlich von:
Armadillo Computing
5225 Marymount Drive
Austin, Texas 78723
USA
Phone/FAX: 512/926-0360.
EMail: Jim Olinger, jolinger@bix.com
Es gibt zwei Oberon-2-Compiler fr den Amiga: AmigaOberon ist wie M2Amiga von A+L und kommerziell. Der Compiler kommt mit einer integrierten Entwicklungsumgebung (incl. freikonfigurierbarem Editor) und umfangreicher Modulbibliothek. Library Linker zum einfachen Erzeugen von AmigaOS Shared Libraries sowie Run-time Source-Level-Debugger sind ebenfalls erhltlich.
Oberon-A ist ein Freeware-Compiler, allerdings erst in einer Beta-Version, insbesondere sind die Modulbibliotheken unvollstndig. (Quelle: Aminet, Directory ‘dev/obero’). @xref{Mail-Listen}.
Fr beide Compiler gibt es Unmengen von Modulen und Bsp.-Sourcen auf AMOK-Disks.
Zustzlich zu den beiden Standalone-Compilern, die vor allem zum Entwickeln von AmigaOS-Applikationen geeignet sind, existiert noch eine Portierung des Oberon System V4, das ebenfalls einen Oberon-2 Compiler beinhaltet. Das Oberon System luft auf dem Amiga als ein AmigaOS-Task auf einem eigenen Screen. Hiermit kann man Software entwickeln, die auch auf allen anderen Implementierungen des Oberon System V4 (z.B. fr Macintosh, Windows oder Sparc) nahezu ohne jede nderung lauffhig ist.
Es gibt einen PD-Compiler namens PCQ (Aminet, Directory ‘dev/lang’ oder Fish-Disk 511), der allerdings kein voller Pascal-Compiler ist und dem sehr wesentliche Dinge fehlen. P2C konvertiert Pascal in C und ist auf der Fish-Disk 341 zu finden. (Aminet: ‘/dev/misc/p2c120.lha’) Ferner gibt es zwei kommerzielle Compiler namens HiSoft-Pascal (von der gleichnamigen Firma) und KickPascal von Maxxon. HiSoft und P2c behaupten, kompatibel zu Turbo-Pascal 5.0 zu sein. HiSoft hat auerdem einen guten Source-Level-Debugger.
| [ << ] | [ < ] | [ Up ] | [ > ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
Viele Drucker kommen mit einem Handbuch, das erklrt, welche
<Esc>-Sequenzen welche Funktion auslsen. Aber wenn man diese Sequenzen
dann einmal ausprobiert, passieren oft merkwrdige Sachen, nmlich entweder
gar nichts oder etwas ganz anderes, als geplant war. Und das hat auch
einen Grund, nmlich die Amiga-Druckertreiber. Diese Treiber sind so
gebaut, da sie nur einen bestimmten Satz ANSI-Esc-Sequenzen
verstehen, nicht die (verschiedenen) druckereigenen, von den verschiedenen
Druckerherstellern definierten. Der Sinn dabei ist, da jede Anwendung
auf dem Amiga nur diesen einen Standardsatz an Sequenzen verwendet und
so nicht zu wissen braucht, welcher Drucker tatschlich angeschloen
ist. Der Druckertreiber bersetzt dann diese Standardsequenzen in die
druckereigenen. Eine Liste der verfgbaren ANSI-Esc-Sequenzen findet
sich im aktuellen Workbench-Handbuch (oder in lteren
AmigaDOS-Handbchern). Wenn Du nun eine Steuersequenz an den Drucker schicken
willst, die es nicht als ANSI-Sequenz gibt, so hast Du zwei Mglichkeiten,
dies doch zu erreichen:
‘Esc[<n>"<x>’
wobei ‘<n>’ die dezimal geschriebene Anzahl an Bytes in der Sequenz ‘<x>’ ist, die gerade die spezielle Drucker-Sequenz enthlt. Diese ANSI-Sequenz sagt dem Druckertreiber, da er die nchsten ‘<n>’ Bytes nicht interpretieren oder bersetzen soll.
Aber beide Methoden haben einen grossen Nachteil, wenn sie in einem Anwendungsprogramm verwendet werden: Man verliert die Druckerunabhngigkeit! Solange man sich an die ANSI-Sequenzen hlt, kann man jeden Drucker der Welt ansteuern, solange es einen Amiga-Druckertreiber fr ihn gibt. Wenn man anfngt, druckereigene Sequenzen zu verwenden, ist das Programm an diesen einen Druckertyp gebunden und mit keinem anderen benutzbar (oder man mte einige dutzend neue Druckertreiber fr dieses Programm erstellen).
Dr. Peter Kittel, peterk@cbmger.de.so.commodore.com
| [ << ] | [ < ] | [ Up ] | [ > ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
Letztens ging eine Kontroverse ber AmigaBasic durch die Netze: Ich sagte, auf dem A1200 luft es einigermaen problemlos, jemand anders berichtete, da es bei jedem kleinsten Fehler sofort komplett abstrzt, was ich nicht nachvollziehen konnte.
Jetzt kann ich es: Es liegt am Sound-Prefs-Editor. Wenn man in ihm die Sound-Ausgabe ganz abschaltet, kann man mit AmigaBasic arbeiten. Wenn hier ein Sound (z. B. Piepsen) angewhlt ist, kollidiert das mit dem Sound, den AmigaBasic offensichtlich zu Fu und nicht ganz korrekt selber erzeugen will, bumm.
Abhilfe also:
Dr. Peter Kittel, peterk@cbmger.de.so.commodore.co
| [ << ] | [ < ] | [ Up ] | [ > ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
Nehmen wir an, wir wollen ein HelloLocalWorld.c schreiben. Das
letztendliche Programm sieht dann ungefhr so aus:
#include "HelloLocalWorld_Cat.h"
#include <clib/exec_protos.h>
struct Library *LocaleBase;
void main(int argc, char *argv[])
{
/* ffne die locale.library. (Kein Abbruch, wenn sie nicht
da ist, weil dann einfach die eingebauten Strings verwendet
werden. Aus diesem Grund auch keine Verwendung des
AutoOpening, auch wenn es der Compiler beherrscht.)
*/
LocaleBase = OpenLibrary("locale.library", 38);
OpenHelloLocalWorldCatalogs(NULL, NULL);
printf(GetString(MSG_Hello));
CloseHelloLocalWorldCatalog();
if (LocaleBase) CloseLibrary(LocaleBase);
}
Die Funktion GetString prft, ob die gewnschten Kataloge vorhanden sind und liefert einen Zeiger auf einen String, entweder den eingebauten oder den Katalogstring. (In unserem Fall den deutschen String.)
Der Hauptunterschied zum gewohnten HelloWorld.c ist also (abgesehen von der minimalen Initialisierung und dem Gegenstck am Programmende, das bei den meisten modernen Programmiersprachen oder unter C mit Hilfe des FlexCat-Paketes sogar auch noch entfllt), Strings durch einen Funktionsaufruf zu ersetzen. Man braucht also eine Datei ‘HelloLocalWorld_Cat.c’, die die Funktionen OpenHelloLocalWorld, GetString, CloseHelloLocalWorld_Cat.h und die eingebauten Strings enthlt (dies knnte ein Array sein, das unter anderem
array[MSG_Hello] = "Hello, local world.\n";
enthlt) und ein Includefile ‘HelloLocalWorld_Cat.h’, das die
ID’s wie MSG_Hello definiert. Es ist nicht ntig zu wissen, wie diese
Dateien intern arbeiten, insbesondere bentigt man auch keine Kenntnis
der locale.library!
Dazu gibt es verschiedene Kataloggeneratoren (im Folgenden KG), nmlich
‘CatComp’ (nur fr Developer), KitCat (nur deutsche
Dokumentation, was hierzulande kein Problem ist), ‘MakeCat’ (das ich
nicht kenne) und FlexCat (das ich empfehle, einerseits, weil
es sehr flexibel im erzeugten Source ist und z.B. Lokalisierung unter 2.0
sowie beliebige Programmiersprachen untersttzt, selbst Amiga-E, Cluster,
Pascal, ... und andererseits, weil es von mir ist ;-) ), die diese Dateien
sowie die Kataloge erzeugen. (Der obige Quelltext knnte je nach KG
leicht unterschiedlich aussehen.) Siehe Aminet, directory ‘dev/misc’.
Wie funktionieren diese KGs? Zunchst erzeugt man eine sogenannte
Katalogbeschreibung (Catalog description), die so aussehen
knnte:
; Mit einem Semikolon beginnende Zeilen sind Kommentare
# language english
; die Sprache der eingebauten Strings
# version 0
; die Katalogversion (0 = beliebig)
MSG_Hello (1/15/30)
Hello, local world
Jeder String wird durch zwei Zeilen wie die letzten beiden definiert: MSG_Hello ist die String-ID, (1/15/30) gibt den Wert der ID sowie die minimale und maximale Lnge an. (Diese Argumente knnen auch weggelassen werden, in welchem Fall einfach die nchste freie ID verwendet wird.)
Nun schreiben wir das Programm. Sobald es fertig ist, wird mit dem KG eine sogenannte Katalogbersetzung (eine fr jede andere Sprache als die eingebaute) erzeugt, die so aussehen knnte:
; Mit einem Semikolon beginnende Zeilen sind Kommentare
## language deutsch
; the catalog language
## version $VER: Deutsch.catalog 1.0 (22.12.93)
; the catalog files version string
MSG_Hello
; Hello, local world
Beachten Sie die leere Zeile nach der String-ID! (Die Argumente von
## language und ## version wren vielleicht leer.) Hier mssten
jetzt die deutschen Strings eingesetzt werden. Mit dem KG wird daraus
dann der eigentliche Katalog erzeugt. (Beachten Sie auch, da
hier die Angaben ber String-ID und Stringlnge fehlen: Sie werden
aus der Katalogbeschreibung bernommen.
Wenn das Programm verndert wird (neue Strings, andere Lngen) und die Katalogbeschreibung sich damit ebenfalls ndert, dann kann der KG analog benutzt werden, um auch die Katalogbersetzung und damit den Katalog auf den neuesten Stand zu bringen.
| [ << ] | [ < ] | [ Up ] | [ > ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
Die folgende Funktion liefert den Window-Zeiger eines CON-Fensters. Sie kann unter allen Versionen des Amiga-OS ausgefhrt werden.
struct Window *getConWindowPtr(BPTR fh)
{
struct Window *w;
struct FileHandle *cfh;
struct StandardPacket *sp;
struct InfoData *id;
struct MsgPort *mp;
w = NULL;
if ((cfh = BADDR(fh))->fh_Type != NULL) {
if (sp = AllocMem(sizeof (struct StandardPacket),
MEMF_PUBLIC | MEMF_CLEAR)) {
if (id = AllocMem(sizeof (struct InfoData),
MEMF_PUBLIC | MEMF_CLEAR)) {
if (mp = CreatePort(NULL, 0)) {
sp->sp_Msg.mn_Node.ln_Name = (char *) &sp->sp_Pkt;
sp->sp_Pkt.dp_Link = &sp->sp_Msg;
sp->sp_Pkt.dp_Port = mp;
sp->sp_Pkt.dp_Type = ACTION_DISK_INFO;
sp->sp_Pkt.dp_Arg1 = MKBADDR(id);
PutMsg(cfh->fh_Type, &sp->sp_Msg);
(void) WaitPort(mp);
(void) GetMsg(mp);
if (sp->sp_Pkt.dp_Res1)
w = (struct Window *) id->id_VolumeNode;
DeletePort(mp);
}
FreeMem(id, sizeof (struct InfoData));
}
FreeMem(sp, sizeof (struct StandardPacket));
}
}
return w;
}
Anmerkungen:
Weitere Informationen finden Sie auf den Seiten 273, 276, 435, 463, 485 und 629 im "Amiga Guru Book" (see section Was ist die beste Dokumentation fr Programmierer?).
Ralph Babel, rbabel@babylon.pfm-mainz.de
| [ << ] | [ < ] | [ Up ] | [ > ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
Pragmas sind spezielle Anweisungen an den C-Compiler. Zwei Probleme entstehen bei der Verwendung von Pragmas:
#ifndef MY_COMPILER
#pragma DoAnything
#endif
Das letztere Problem lt sich umgehen, indem man Pragmas wie folgt in eigene Include-Files setzt. (Das gleiche gilt brigens auch fr Prprozessor-Kommandos wie #asm (Aztec-C) oder #extern (C++).)
#ifndef MY_COMPILER
#include <mypragmas.h>
#endif
Aber was machen Pragmas auf dem Amiga? Meistens werden sie verwendet,
um dem Compiler mitzuteilen, wie gewisse Library-Funktionen aufgerufen
werden. (Tatschlich wird fast immer diese Verwendung gemeint, wenn
Amiga-Besitzer ber Pragmas sprechen.) Gewhnliche C-Funktionen erwarten
ihre Argumente auf dem Stack, Library-Funktionen dagegen in bestimmten
Registern. Ferner erwarten sie den Library-Base-Pointer in Register a6.
Betrachten wir eine Pragma-Anweisung von Aztec-C:
#pragma amicall(SysBase,0xd2,FreeMem(a1,d0))
Dies weist den Compiler an, das erste Argument in Register a1 und das zweite in d0 zu laden. Ferner wird der Inhalt der Variablen SysBase in Register a6 geladen. Maxon-Pragmas sehen genauso aus, Dice- und SAS-Pragmas sind allerdings etwas komplizierter:
#pragma libcall SysBase FreeMem d2 0902
Hier ist d2 (wie 0xd2 oben) der Library-Vektor-Offset (siehe
nchstes Beispiel). Die letzte Ziffer ist die Zahl der Argumente, die
davorstehende 0 ein Code fr das Register mit dem Ergebnis und die davor
stehenden Ziffern sind Codes fr die Register mit den Argumenten in
verkehrter Reihenfolge. (Die Codes bedeuten 0=d0, 1=d1, .., 8=a0, 9=a1, a=a2,
..)
Ein Kommando wie ‘FreeMem(fib,sizeof(*fib);’ wrde ein Compiler nun in folgenden Code bersetzen:
move.l _fib,a1
move.l 260,d1 ; sizeof(struct FileInfoBlock)
move.l _SysBase,a6
jsr -0xd2(a6) ; 0xd2 = _LVOFreeMem
FreeMem in dieser Art aufzurufen ist krzer und schneller als zunchst die Argumente auf den Stack zu legen und dann eine Funktion _FreeMem aufzurufen, die letzten Endes doch nur dasselbe tun und die Argumente vom Stack in dieselben Register laden wrde.
Das Portierungsproblem der Pragmas umgeht man, indem man sie folgendermaen in den eigenen Quelltext einbindet:
/* SAS/C, Dice und GNU-c (ab Version 2.6.1) machen es */
/* ganz einfach: */
#if defined(__SASC) || defined(_DCC) || defined(__GNUC__)
#include <proto/exec.h>
#else
/* Lade den Funktionsprototyp. Dieser ist nicht vom */
/* verwendeten Compiler abhngig. */
#include <clib/exec_protos.h>
/* Pragmas sind vom Compiler abhngig, aber wenigstens */
/* die Namen der Dateien mit Pragmas sind relativ */
/* einheitlich. */
#ifdef AZTEC_C
#include <pragmas/exec_lib.h>
#elif defined(__MAXON__)
#include <pragmas/exec_pragmas.h>
#endif
/* Deklariere SysBase-Variable */
extern struct ExecBase *SysBase;
#endif
Das obige Beispiel kann problemlos mit allen angegebenen Compilern verwendet werden und produziert optimalen Code. (Die proto/*.h-Files machen brigens auch nichts anderes als clib/*_protos.h und pragmas/*_pragmas.h mit #include einzulesen und dann die SysBase-Variable zu deklarieren.)
Eine abschlieende Frage bleibt allerdings: Wie bekommt man die Pragmas?
Die meisten Compiler haben bereits fertige Pragmas im Lieferumfang.
Allerdings hilft das nicht, wenn man z.B. eine neue Library benutzen
mchte oder nur die Pragmas einer veralteten Version hat. In diesem Fall
kann man die Pragmas selbst aus den sogenannten FD-Files erzeugen.
Dazu haben die meisten Compiler ein Utility namens fd2pragma.
(Das NDU hat z.B. ein Directory namens FD, in dem die FD-Files aller
Libraries und Devices des OS enthalten sind. see section Wo bekomme ich die Amiga-Include-Dateien?) Es gibt
auch ein frei kopierbares fd2pragma, das Pragmas fr Aztec, Dice, SAS und
Maxon sowie LVO-Files fr den Aztec-Assembler und eventuelle Tag-Versionen
produziert. (Aminet, ‘dev/misc/fd2pragma2_0.lha’ oder auf den
Fish-CDs)
Fr Pragmas unter dem gcc siehe @ref{Inline-Dateien}.
| [ << ] | [ < ] | [ Up ] | [ > ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
Zunchst sollte man sich versichern, da die Funktion tatschlich fehlt:
Z.B. Floating-Point-Funktionen befinden sich in einer speziellen
Link-Library, die erst mit der Option ‘-lm’ eingebunden wird.
Ferner kann es eine fehlende Variable sein: Wenn man z.B. ohne es zu
bemerken eine Intuition-Funktion benutzt, dann wird der Linker ber das
Fehlen eines Symbols IntuitionBase klagen. In diesem Fall mu
man also lediglich das Folgende irgendwo im globalen Teil seines
Quelltextes einbauen:
struct Library *IntuitionBase;
(Und vergessen Sie nicht, die Library mit OpenLibrary() zu erffnen und mit CloseLibrary() zu schlieen!) :-)
Allerdings knnte die Funktion natrlich tatschlich fehlen. Wenn man zum Beispiel nur die Version 2.0 der amiga.lib hat, dann fehlen etwa die Locale-Funktionen oder die Memory-Pool-Funktionen, obwohl sie prinzipiell verwendbar sind. (2) Die einfachste (und beste) Lsung ist, das sogenannte NDU zu kaufen. See section Wo bekomme ich die Amiga-Include-Dateien?. Wer nicht solange warten mchte, fr den ist die Frage, welche Art von Funktion in seiner Link-Library fehlt:
#include <clib/dos_protos.h>
#include <pragmas/dos_pragmas.h> /* Evtl. anderer Name */
void *AllocDosObjectTags(ULONG objtype, Tag tag1, ...)
{ return(AllocDosObject(objtype, (struct TagItem *) &tag1);
}
Mit fd2pragma kann das auch automatisch geschehen. See section Was sind Pragmas?.
| [ << ] | [ < ] | [ Up ] | [ > ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
Wenn Sie sich ber den Namen einer fr einen bestimmten Zweck geeigneten Funktion im Unklaren sind, dann gibt es folgende Mglichkeiten:
Dr. Peter Kittel, peterk@cbmger.de.so.commodore.com
| [Top] | [Contents] | [Index] | [ ? ] |
Nur bei einem zustzlichen Prozessor
Dieses Problem betrifft vor allem Besitzer von Aztec-C, das seither nicht weiter untersttzt wird und von Dice, der manchmal etwas unvollstndig ist. Ich besitze beide ..
| [Top] | [Contents] | [Index] | [ ? ] |
This document was generated on July 20, 2024 using texi2html 5.0.
The buttons in the navigation panels have the following meaning:
| Button | Name | Go to | From 1.2.3 go to |
|---|---|---|---|
| [ << ] | FastBack | Beginning of this chapter or previous chapter | 1 |
| [ < ] | Back | Previous section in reading order | 1.2.2 |
| [ Up ] | Up | Up section | 1.2 |
| [ > ] | Forward | Next section in reading order | 1.2.4 |
| [ >> ] | FastForward | Next chapter | 2 |
| [Top] | Top | Cover (top) of document | |
| [Contents] | Contents | Table of contents | |
| [Index] | Index | Index | |
| [ ? ] | About | About (help) |
where the Example assumes that the current position is at Subsubsection One-Two-Three of a document of the following structure:
This document was generated on July 20, 2024 using texi2html 5.0.